home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / proboard / pb_dbv.zip / PB-DBV.DOC < prev    next >
Text File  |  1996-04-24  |  7KB  |  207 lines
  1. ┌─────────────────────────────────────────────────────────────────────────────
  2. │  PB-DBV 1.0                                 written by Peter van der Linde
  3. └─────────────────────────────────────────────────────────────────────────────
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.     PB-DBV - A DBase3/4 compatible *.dbf-Viewer/Editor for ProBoard BBS 2.1x
  14.                                _version 1.0_ 
  15.          copyright (c) 1996 Peter van der Linde, all rights reserved
  16.                    2:285/305.9  -  pvdl@aoxomox.xs4all.nl
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  WHAT IS PB-DBV?
  30.  
  31.  PB-DBV is a VIEWER/EDITOR PEX that gives bbs-users access to *.DBF files 
  32.  produced by dBase3/4 or compatible database programs.
  33.  Although not a full-blown Remote DBase-Door for Proboard BBS (yet ;-), it 
  34.  allows Proboard-users to browse, list, search, and optionally, add, edit or
  35.  delete records.
  36.  
  37.  
  38.  
  39.  LIMITATIONS:
  40.  
  41.  Index files are not supported, memo-fields will not be visible 
  42.  Max. 128 fields 
  43.  Max. 65535 records 
  44.  No maintainance yet.. (sorting,deleting,creating of *.dbf files),
  45.   PB-DBV is a *.dbf viewer/editor only. 
  46.  It is recommended to use dBase 3 or higher for maintainance.
  47.  
  48.  
  49.  INSTALLATION.
  50.  
  51.  In the menu-editor use function 60 to install PB-DBV.PEX
  52.  
  53.  Syntax: pb-dbv <path>filename<.dbf> [add] [edit] [delete] [f]
  54.                                                                                 
  55.  ╔════════════════════════════════════════════════════════════════════════════╗
  56.  ║ 0        1         2         3         4         5         6         7     ║
  57.  ║ 12345678901234567890123456789012345678901234567890123456789012345678901234 ║
  58.  ║ ;░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  59.  ║                                                                            ║
  60.  ║ Hotkey   : 0                                                               ║
  61.  ║ Function : 60 - Run ProBoard SDK File                                      ║
  62.  ║ Data     : pb-dbv c:\dbase\dbf\sell.dbf                                    ║
  63.  ║                                                                            ║
  64.  ║ Min.Level: 25                                                              ║
  65.  ║ Flags    : --------------------------------                                ║
  66.  ║                                                                            ║
  67.  ╚════════════════════════════════════════════════════════════════════════════╝
  68.  
  69.  Above example shows how to allow the user searching and browsing through
  70.  'sell.dbf'.
  71.  
  72.  
  73.  
  74. SECURITY.
  75.  
  76.  Adding records allowed:
  77.           pb-dbv c:\dbase\dbf\sell.dbf add
  78.  
  79.  Adding and editing allowed:
  80.           pb-dbv c:\dbase\dbf\sell.dbf add edit
  81.  
  82.  Deleting (,adding and editing) allowed:
  83.           pb-dbv c:\dbase\dbf\sell.dbf del
  84.  
  85.  When the Delete option is installed, the user can also add and edit
  86.  records. If a user is allowed to delete records it's obvious to allow 
  87.  him/her the 'ADD' and 'EDIT' functions too..
  88.  
  89.  Proboard Level and Flags can further securely decide which users or levels 
  90.  are allowed to use the add/edit/delete options..
  91.  Only if activated the add, edit or delete-option will be visible in
  92.  the menu as to spare users a frustrating "not allowed to..." message 
  93.  and save the sysops time to explain why...
  94.  
  95.  PB-DBV logs its activities to PROBOARD.LOG
  96.  The search actions of users can also written to PROBOARD.LOG when
  97.  activated:
  98.           pb-dbv c:\dbase\dbf\sell.dbf f
  99.  
  100.  
  101.  
  102.  
  103. NOTE!
  104.  
  105.  Records will only be marked to be deleted. Packing and sorting records
  106.  will have to be done by dBase3/4 or any other program which can do
  107.  maintainance on *.DBF files.
  108.  
  109.  
  110.  
  111. MAINTAINANCE EXAMPLE WITH dBASE3/4.
  112.  
  113.  An example for Packing Records with dBase3/4 using a backup-file
  114.  (k_sell.dbf) for deleted records:
  115.  
  116.   - Copy the filestructure of sell.dbf to k_sell.dbf
  117.   - Create textfile 'k_sell.prg':
  118.  
  119.  use sale.dbf
  120.  set deleted off
  121.  copy all for deleted() to tempfile
  122.  pack
  123.  use k_sell.dbf
  124.  append from tempfile
  125.  close databases
  126.  erase tempfile.dbf
  127.  quit
  128.  
  129.  In the nightly maintainance-event the (marked to be) deleted records
  130.  will be removed from sell.dbf and copied to k_sell.dbf.
  131.  In the bbsbatch-file:
  132.  
  133.    <path> dbase k_sell.prg
  134.  
  135.  dBase will wait 10 seconds for a keypress and then start executing 
  136.  k_sell.prg. After (dbase) k_sell.prg is finished, it returns control 
  137.  to the bbsbatch-file.
  138.  Deleted and packed records can always be recovered this way depending
  139.  on how long the backup-file (k_sell.dbf) will be kept.
  140.  (In the included sell.dbf example 1 record is marked for deletion and 
  141.   will be deleted and moved to k_sell.dbf using dbase3/4 and k_sell.prg)
  142.  
  143.  
  144. DISCLAIMER.
  145.  
  146.  This program is provided as is.  You may use it at your own risk.
  147.  There is no warranty of any kind or any form covering this program.
  148.  Although this software has been tested thoroughly and prior to release,
  149.  there is NO guarantee it is 100% error or bug free. The author of PB-DBV
  150.  will not be held responsible for any damage done to your software/hardware
  151.  in any case.
  152.  
  153.  
  154.  
  155.  
  156. REGISTRATION.
  157.  
  158.  Although this is the first public gamma FREEWARE version and you don't have 
  159.  to register it (1.0), future versions of PB-DBV will be SHAREWARE!
  160.  
  161.  The writing of almost 3000 lines of code takes a lot of time. 
  162.  If, after a trial period of maximum 60 days, you (and your users) still
  163.  like and use this program, you are encouraged to register PB-DBV.
  164.  That would really motivate and stimulate a programmer to keep him supporting 
  165.  and improving his software...
  166.  There are NO 'please register' messages or delays built into this
  167.  version of PB-DBV. 
  168.  
  169.  Registered users will be supported and notified by netmail or email of 
  170.  bugfixes and/or updates.
  171.  
  172.  To register and receive a registrationform, send a netmail to:
  173.           Peter van der Linde at 2:285/305.9  Subject: pbdbv.reg
  174.  or an email to:
  175.           fileserver@aoxomox.xs4all.nl
  176.  in the messagebody:
  177.           get proboard/pbdbv.reg
  178.  
  179.  Fill and return the registrationform and send $15 (USA), DM15 (Germany)
  180.  or f15 (Holland) by cheque or cash to:
  181.  
  182.     Peter van der Linde,
  183.     Willem de Vries Robbéweg 50,
  184.     4206 AM  Gorinchem,
  185.     the Netherlands.
  186.  
  187.  A registered version will then be sent to you via internet, fidonet
  188.  (on diskette via snailmail ADD $5|DM5|f5).
  189.  
  190.  PB-DBV 1.0 can be file-requested via internet by sending an email to:
  191.           fileserver@aoxomox.xs4all.nl
  192.  in the messagebody:
  193.           get proboard/pb-dbv.zip uue
  194.  
  195.  PB-DBV 1.0 will then be sent to you UUENCODED.
  196.  
  197.  
  198.  If you have any problems, suggestions or remarks, please report them to:
  199.           pvdl@aoxomox.xs4all.nl
  200.           or to: Peter van der Linde at 2:285/305.9
  201.  
  202.  
  203.  
  204. Thanks for reading!
  205. regards,
  206. Peter.
  207.